Skip to main content

Running Java Engine on Linux

This article explains how to install and use the Fluent Java Engine in Linux. This tutorial specifically uses Ubuntu Server 18.04 LTS, but the steps should work on any Linux system with little extra effort.

After completing this tutorial you will have installed the Fluent Java Engine on a Linux system.

Install the JDK​

The first thing needed is a JDK (Java Development Kit) installation. This isn't too hard to come by, but depending on your distribution of Linux, this step might be slightly different.

In the terminal, run the bellow commands to install Java 8:

sudo apt update
sudo apt install openjdk-8-jdk openjdk-8-jre

Verify the installation by running the following command:

java -version

The Oracle JDK isn't available in the default repositories on some systems, which is why we use OpenJDK here. There are guides on the internet that show you how to get the correct PPA repositories set up to get the Oracle JDK, should you need that option.

For other systems, such as Debian, Fedora, or any other flavor of Linux, this command will be different, but it should be pretty straightforward if you are familiar with your operating systems package manager.

Download and Setup the Engine​

The engine is available from the downloads page, so we can download it via the terminal with this command:

wget https://cdn.windwardstudios.com/Archive/22.X/22.1.0.85/SetupWindwardReportsJava.zip

Note: the above command is to download Java Engine version 22.1.0.85

We're going to install it to /opt/fluent to make things easy. So we will create the directory with the following command:

sudo mkdir /opt/fluent

Then we will unzip the contents of the zip file we downloaded earlier, and move the contents to /opt/windward:

sudo unzip SetupWindwardReportsJava.zip -d /opt/windward

The zip file contains:

  1. jars: A directory containing all the jars required for the Java Engine
  2. The Fluent License Agreement pdf

Then we need to place the jar files in the correct location so Java can find them:

sudo cp /opt/fluent/jars/* /usr/share/java

And finally, tell Java where to find them. We're adding it to the /etc/environment file for future use. The export command allows us to work with it during this session. Run the following commands:

sudo cp /etc/environment /etc/environment.bk
printf "CLASSPATH=\".:/usr/share/java/*\"\n" | sudo tee -a /etc/environment
export CLASSPATH=.:/usr/share/java/*

The Java engine is now setup on your Linux machine.

Checkout our Java Engine samples on github.